PATHMac OS 8 Developer Documentation > Operating System Services > Multiprocessing Services >

Adding Multitasking Capability to Applications Using Multiprocessing Services

   

MPCreateQueue

Creates a message queue.

OSStatus MPCreateQueue (MPQueueID *queue);
queue
A pointer to a variable of type MPQueueID . On return, the variable contains the ID of the newly created message queue.
function result
A result code. See Result Codes for a list of possible values. If a queue could not be created, MPCreateQueue returns kMPInsufficientResourcesErr .
DISCUSSION

This call creates a message queue, which can be used to notify (that is, send) and wait for (that is, receive) messages consisting of three 32-bit words in a preemptively safe manner.

Message queues are created from dynamically allocated internal resources. Other tasks may be competing for these resources so it is possible this function may not be able to create a queue.

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

SEE ALSO

The function MPDeleteQueue .

The function MPSetQueueReserve .

© 1999 Apple Computer, Inc. – (Last Updated 07 May 99)